Skip to content

docs: record Hysteria2 Gecko obfs deferral#11

Merged
hawkff merged 1 commit into
mainfrom
docs/gecko-deferral
Jun 15, 2026
Merged

docs: record Hysteria2 Gecko obfs deferral#11
hawkff merged 1 commit into
mainfrom
docs/gecko-deferral

Conversation

@hawkff

@hawkff hawkff commented Jun 15, 2026

Copy link
Copy Markdown
Owner

Docs-only. Records why Phase 9 (Gecko core) is deferred and captures the exact version refs for when it becomes available.

Findings:

  • Gecko obfs exists only in sing-box v1.14.0-alpha.31 + untagged sing-quic commit 9467ede27fb7 (gecko.go).
  • No stable sing-box/sing-quic release has it; upstream main does not either.
  • This fork runs starifly/sing-box 1.12.19-neko-1 + sing-quic 0.5.2 (Salamander only).
  • Pinning to upstream 1.14-alpha would drop all starifly protocol additions; backporting gecko.go into a forked sing-quic is high-risk. Chose to defer.

Includes the future core + Android implementation plan for when Gecko ships in a stable starifly/sing-box.

No functional app changes.

@hawkff
docs: record Hysteria2 Gecko obfs deferral and findings
6d559dc 
Gecko obfs exists only in sing-box v1.14.0-alpha.31 + untagged sing-quic
commit 9467ede27fb7 (gecko.go); no stable release has it, and this fork's
core is starifly/sing-box 1.12.19 + sing-quic 0.5.2. Deferred until Gecko
lands in a stable starifly/sing-box; documents exact refs and the future
core + Android work split.
@coderabbitai

coderabbitai Bot commented Jun 15, 2026 •
edited
Loading

Copy link
Copy Markdown

Review Change Stack

Caution

Review failed

Pull request was closed or merged during review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 486e23a8-694f-496e-b0a0-4298e3bf8ede

📥 Commits

Reviewing files that changed from the base of the PR and between 82da6a2 and 6d559dc.

📒 Files selected for processing (1)
  • docs/maintenance/hysteria2-gecko-deferral.md
📝 Walkthrough

Summary by CodeRabbit

  • Documentation
    • Added maintenance documentation regarding deferred feature implementation and future roadmap considerations.

Walkthrough

A new maintenance documentation file docs/maintenance/hysteria2-gecko-deferral.md is added. It records the decision to defer Hysteria2 "Gecko" QUIC obfuscation support, cites upstream pre-release status, summarizes considered options, and provides a checklist of future core-pin and Android implementation steps.

Changes

Hysteria2 Gecko Deferral Documentation

Layer / File(s) Summary
Gecko deferral maintenance note
docs/maintenance/hysteria2-gecko-deferral.md		 New file documenting the deferral rationale, upstream evidence (Gecko exists only in pre-release sing-box/sing-quic), options considered, and a structured checklist of future steps for core pinning and Android feature/UI/schema changes.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Poem

A rabbit read the docs with care,
"Gecko's not ready — defer it, be fair!"
🐇 Upstream pre-release, not pinned nor stable,
We jot it all down on the maintenance table.
When Gecko lands safe, we'll hop to the code,
But for now, this note lightens the load! 🦎

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Title check ✅ Passed The title accurately and specifically describes the main change: documenting the decision to defer Hysteria2 Gecko obfuscation support.
Description check ✅ Passed The description is directly related to the changeset, providing detailed context about Gecko availability, current dependencies, and the rationale for deferral.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

Comment @coderabbitai help to get the list of available commands and usage tips.

@hawkff hawkff merged commit f685fc6 into main Jun 15, 2026
2 of 3 checks passed
@hawkff hawkff deleted the docs/gecko-deferral branch June 15, 2026 19:38
This was referenced Jun 17, 2026
Merged
Merged
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@hawkff